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| QUICK START 


Installing Novell Nsure UDDI Server 


This document provides instructions for installing Novell Nsure UDDI Server. 


SUPPORTED PLATFORMS 
+ NetWare® 6.0 Support Pack 3 or later 


+ Windows* NT* 4.0 Server with Support Pack 6.x 
+ Windows 2000 Server with Support Pack 2 

+ Red Hat* Linux 7.2 or later 

¢ Solaris* 8 or later 


+ IBM* AIX 5.1 or later 


SOFTWARE REQUIREMENTS 
+ JVM* 1.4 and later 


+ Novell eDirectory™ 8.7 

+ Novell iManager 1.5 

+ Internet Explorer 5.5 Support Pack 2 or Netscape* Navigator 7.0 or later 

+ Any of the following Application Servers that support Servlet 2.3 specifications: 
+ Apache/Tomcat 
+ Novell exteNd™ 


+ BEA* WebLogic 


BEFORE YOU START 
Before you install and configure the Novell Nsure UDDI Server, keep in mind the following: 


+ You need write permissions to the installer directory to install the UDDI server, UDDI 
administration, and UDDI user interfaces and eDirectory rights to configure UDDI. 





Novell. 


If you are installing over Apache/Tomcat, also ensure that you have write permissions to the 
httpd.conf file. 


Ensure that the ldapTLSRequired option has been disabled before installation by executing 
the following steps in iManager: 


+ Click the LDAP Management role, then click the LDAP overview task. 


+ Select the View LDAP Groups page, then click the group object and disable the Require 
TLS for Simple Binds with Password option. 


+ Select the View LDAP Server page, click the server object, then click Refresh. 


Ensure that you have at least 6 MB of free disk space in each of the directories where you 
install the UDDI server and the UDDI administration/user interface components. 


If you choose to deploy over Tomcat, we strongly recommend you to install Novell Nsure 
UDDI Server in an Apache/Tomcat integrated environment because a standalone Tomcat 
setup has security and scalability limitations. 


If you are using an Apache/Tomcat combination, both components should be integrated 
before you begin installation. 


On Windows, Linux, Solaris, and AIX, set the environment variable to point to the 
java_home/bin where java_home is the top-level directory where Java* 1.4 is installed. 


On Windows, Linux, Solaris, and AIX, set the TOMCAT_HOME or CATALINA_HOME environment 
variable to point to the Tomcat root directory, if you want to install the administrative snap- 
ins and the UDDI server against Apache/Tomcat. 


INSTALLING UDDI ON NETWARE 
Novell Nsure UDDI Server supports two types of installation: 


+ NetWare integrated installation 


+ Standalone installation 


To install UDDI integrated with NetWare: 


1 Select Novell Nsure UDDI Server from the component selection page. 


Also, disable the TLS Required for Bind option for LDAP server. 


NOTE: The UDDI server files are located at sys:\uddi. 


To install a standalone UDDI: 


1 Execute the following command at the prompt: 





path\install\UDDIInstall path\install 


where path is the directory where the installation files are stored. 





This invokes the installer that displays the Introduction page. 
2 Click Next to accept the license agreement. 
3 Click Next to continue installation. 


4 Select UDDI Server, then continue with “Completing the Installation Procedure for the UDDI 
Server” on page 4. 


or 
Select UDDI Admin/User Interface, then continue with “Completing the Installation 


Procedure for the UDDI Administration and User Interfaces” on page 6. 


INSTALLING UDDI ON WINDOWS 
Ensure that the Registry.dll file exists in the same directory as the install executable. 


1 Double-click UDDIInstall.exe from path/install. 

where path is the directory where the zip file is extracted. 

This invokes the UDDI Installer and displays the Introduction page. 
2 Click Next to accept the license agreement. 
3 Click Next to continue installation. 


4 Select UDDI Server, then continue with “Completing the Installation Procedure for the UDDI 
Server” on page 4. 


or 
Select UDDI Admin and User Interface, then continue with “Completing the Installation 


Procedure for the UDDI Administration and User Interfaces” on page 6. 


INSTALLING UDDI ON LINUX, SOLARIS, OR AIX 
1 Execute the following command at the prompt: 


path/install/UDDIInstall.bin 


where path is the directory where the tar file is extracted. 

This invokes the UDDI Installer and displays the Introduction page. 
2 Click Next to accept the license agreement. 
3 Click Next to continue installation. 


4 Select UDDI Server, then continue with “Completing the Installation Procedure for the UDDI 
Server” on page 4. 


or 





Select UDDI Admin and User Interface, then continue with “Completing the Installation 
Procedure for the UDDI Administration and User Interfaces” on page 6. 


COMPLETING THE INSTALLATION 
This section contains the following information: 


+ “Completing the Installation Procedure for the UDDI Server” on page 4 
+ “Completing the Installation Procedure for the UDDI Administration and User Interfaces” on 


page 6 


Completing the Installation Procedure for the UDDI Server 
If you are installing the UDDI server for the first time, perform both Step 1 and Step 2. For any 


subsequent installation, you can choose either of them based on your needs. For example, you 
should select Install UDDI server if you want to install the required files, or you should select 
Configure UDDI Server, if you want to configure the UDDI server on different eDirectory 


containers. 


1 Select Install UDDI Server to install all the required files for the UDDI server. 
The UDDI server configuration does the following: 
+ Installs the file novelluddi.war 


¢ Installs the sample scripts for deploying and undeploying the Application Server that is 
selected. 


2 Select Configure UDDI Server to configure the UDDI server. The UDDI server configuration 
does the following: 


+ Extends the eDirectory schema with UDDI specific classes and attributes. 
+ Creates user, server and base containers/contexts. 


+ Creates 25 canonical tModel objects and the UDDI Server object under the server 
context with the name server name-UDDI and enables public Read rights to it. 


3 If the install has detected a previous installation of Novell Nsure UDDI Server, you are 
prompted to confirm the uninstallation before proceeding. 


If you select Yes, the previous version of the UDDI Server is uninstalled. 


4 If you selected Install UDDI Server in Step 1, you will see the UDDI Server Input screen. You 
can select the Application Server over which you want to deploy the UDDI Server and also 
specify the path where you want to install the files. 


The following directories are created under the specified path: 


+ UDDIUninstall: Contains the uninstaller. 





+ conf: Contains the uddi_v2.xsd (created if Install UDDI server is selected) and uddi.conf 
(created if Configure UDDI server is selected) files. 


+ logs: Contains files that contain log information of the UDDI server. Typically, the log 
file is named as uddi-log-timestamp.log where timestamp is the time when the log file 
was generated. 


If you selected Configure UDDI Server in Step 1, you will see the Application Server Port 
Number screen. This is the port where your application server is listening. 


5 If you selected Configure UDDI Server in Step 1, you will see the UDDI Administrator 
Credentials page. Complete the server configuration by supplying the following information: 


5a Enter the eDirectory administrator's DN, password, and the UDDI operator's e-mail ID. 
The DN must be specified in LDAP format. 

5b Enter the LDAP Port number if it is other than 389. 

5c Click Next. 

5d Enter the eDirectory containers where UDDI objects will be created. 


These objects will house UDDI data. You can use the default values or change them 
based on your eDirectory configuration. 


IMPORTANT: If you specify a server context where a UDDI Server object already 
exists, the object will be retained. 


The server context, base context, and the user context must be specified in LDAP 
format. The base context must be different from the user context and must not exceed 
28 characters. 


5e Enter the operator’s name for the UDDI registry. 
5f Click Next. 
6 Review the pre-installation page and click Next to start installation. 
If the installation is successful, a Congratulations! message is displayed. 


The Novell_Nsure_UDDI_Server_InstallLog.log file contains install log messages that can be 
used to verify any errors that occurred during installation. 





7 Modify the deployment script and the deployment plan (in case of exteNd App Server) as per 
your settings and execute it to deploy the novelluddi.war file in the selected Application 
Server. Restart the Tomcat engine to start UDDI service. 


8 Open a browser window from any desktop and enter the following URL: 
http: //hostname:portnumber/novelluddi/servlet/rpcrouter 


where hostname is the server name or IP address of the server where the UDDI service is 
running and portnumber is the port at which the Application Server is listening. 





The following message is displayed in your browser window if the UDDI service is running: 


UDDI Server Status 


Server Initialized Successfully. 


Completing the Installation Procedure for the UDDI Administration and User 
Interfaces 
To install UDDI Admin and User Interfaces: 


1 Select UDDI Admin/User Interface in the Install Set page. 


UDDI Install tries to detect the directory where Novell iManager 1.5 is installed and displays 
the directory name in the Admin Utility Install Folder Detected field. 


2 Click Next if it is already detected 
or 


Click Choose to select the directory where iManager 1.5 is installed. This is the webapps 
directory of Tomcat. 
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